home *** CD-ROM | disk | FTP | other *** search
/ Australian Personal Computer 1998 July / apc37.iso / netkit / mac / dcomet / dcomet.hqx / Documents / A5. Internationalizing dC < prev    next >
Encoding:
Text File  |  1998-01-29  |  4.5 KB  |  114 lines
  1.  
  2.  
  3.              A5. Internationalizing dC
  4.  
  5. _____________________________________________________________________________
  6.  
  7.             dataComet documentation (Rev. 6/25/97):
  8.             Copyright 1997 databeast, Inc. All Rights Reserved.
  9.  
  10.         __________________________________________________________________
  11.  
  12.  
  13.    To translate dataComet into a language other than English, you need to use a tool such as ResEdit to modify string resources embedded in dataComet's "resource fork".  If a document containing modified versions of these resources is placed in the dataComet "Fonts" folder, the modified versions will automatically replace the default English version.
  14.  
  15.    ResEdit documents containing these resources can be retrieved from <http://www.databeast.com/datacomet/resources.html>.
  16.  
  17.  
  18.    __________________________________________________________________
  19.  
  20.     Resource                  Function
  21.       Type      
  22.    __________________________________________________________________
  23.  
  24.  
  25.       CNTL      Names of the buttons that appear in the button bar.
  26.  
  27.       DLOG      You can rearrange the items to fit the new text, as 
  28.                 long as the items are not renumbered.
  29.  
  30.       DITL      Dialog text is contained in the 'DITL' resources.  
  31.  
  32.                 The name of each item should be duplicated exactly in the 
  33.                 documentation so that Control-Click command searching will
  34.                 work automatically.
  35.  
  36.       MENU      Menu items.
  37.  
  38.                 The name of each item should be duplicated exactly in the 
  39.                 documentation so that Control-Click command searching will
  40.                 work automatically.
  41.  
  42.       STR#      Strings used by dataComet, grouped according to function.
  43.                 Empty strings are defined to allow for future expansion
  44.                 within a general category, so make sure you translate the
  45.                 ones at the very end!
  46.  
  47.       TEXT      Some copyright information, which does not have to be translated.
  48.  
  49.    __________________________________________________________________
  50.  
  51.  
  52.    Naturally, the dataComet documentation contained in the "Documents" folder should be translated into the target language also for a truly complete implementation of a foreign-language version of dataComet.
  53.  
  54.  
  55.    __________________________________________________________________
  56.  
  57.                       String resources (STR#)
  58.    __________________________________________________________________
  59.  
  60.  
  61.      128  "General Pascal strings":  Contains some important globals:
  62.  
  63.            Finder name, names of important documents (e.g., "Comet Default")
  64.            and folders (e.g., "Fonts"; the "Documents" folder name is an
  65.            exception, since it is picked up from the menu item title).
  66.  
  67.      129  "Keycode name table":  for the key macros and the Key Macro 
  68.            dialog; key titles need to correspond to the national keyboard
  69.            key codes being used.
  70.  
  71.      130  "General strings":  Contains general alert strings.  Note globals:
  72.  
  73.              String 1, "enablefinder", is the default password for 
  74.                 returning from secure kiosk terminal mode;
  75.  
  76.              ".edit", ".print", etc., control file-suffix actions, e.g.,
  77.                 the first identifies a sessions' ".edit" text file, and
  78.                 the second triggers automatic printing of downloaded files.
  79.  
  80.      131  "MacTCP":  Strings specific to MacTCP alerts.
  81.  
  82.      132  "TFTP":  Strings for the TFTP server.
  83.  
  84.      134  "VT100 function keys":  Labels for the buttons on the left.
  85.  
  86.      135  "IBM function keys":  Labels for the buttons on the left.
  87.  
  88.      136  "Color dialog strings"
  89.  
  90.      137  "Terminal responses":  Modify only if you wish to change
  91.            the gruesome details of terminal responses.
  92.  
  93.      140  "Font names":  You can customize automatic font selection
  94.            by modifying the name pairs; the pairs represent normal/bold
  95.            fonts to be used as the default for IBM 3270, ISO Latin 
  96.            (the primary default), DEC-Multinational, and PC-ANSI 
  97.            emulation when an emulator type is selected.  The correct
  98.            translation is automatically selected.
  99.  
  100.  
  101.    __________________________________________________________________
  102.  
  103.  
  104.      NOTE:  In translation, always preserve '%d', '%s', and other 
  105.      substrings of the form '%<character>' when they appear in strings:  
  106.      this notation is used by C-language routines called by dataComet 
  107.      to format menu and dialog text.
  108.  
  109.    __________________________________________________________________
  110.  
  111.  
  112. _____________________________________________________________________________
  113.  
  114.